TIM FOR WINDOWS DEMO PROGRAM Installation directives TIM for Windows is a program for scientific image processing. It operates on images from the real-world, in order to get data out of them. Images can be aquired using a video camera and a frame grabber, or imported as a TIFF file. TIMWIN has a large set of operations and functions, including: * image processing: pixel operations, linear and non-linear filters, bitplane- and morphologic operations, 2D-FFT, graphics * operations for measurement and control * a full language for writing scripts and analyzing results (including compiler, editor & debugger) * an extended on line help You can issue commands using menus, but for experienced users a command line interface is available with history, command line editing, etc. TIMWIN runs on a PC-AT with: * Microsoft Windows 3.1 in standard or enhanced mode * At least 2, but preferably 4 MB of memory * A VGA display (super VGA, 256 colours recommended for image display) * 2.5 MB of free disk space * A frame grabber is optional. With no frame grabber, the necessary image storage is created in standard memory, which will increase the memory requirements. Supported frame grabbers: Imaging Technology Inc.: PCVision, PCVisionPlus, VFG Imagenation Corp.: Cortex-I The TIMWIN-Demo program is a limited version of the full program: * only 256x256 image processing is supported * the compiler is disabled, so you cannot execute self-made command file programs * writing images to disk is disabled The TIMWIN-Demo program is distributed on floppy disk and by anonymous ftp from several sites. Conditions ~~~~~~~~~~ This software is intended to give the image processing community an impression of the possibilities of TIM for Windows. You may use, copy and distribute this software freely. You may not: - modify the software, - remove the above described limitations, - sell the software. TIM and TIMWIN are registered trade marks. DIFA and TEA cannot be held responsible or liable for any damages that might result of the use of TIMWIN Demo. Using TIMWIN Demo implies acceptance of these conditions. Installation from zipped files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The TIMWIN-Demo files are packed in a compressed file: timwin.zip To install TIMWIN demo from this file, follow the instructions below. * Unpack the file TIMWIN.ZIP (use an unzipper that is compatible with version 2.04, e.g. the newest version of PKUNZIP). You can do this in a temporary directory, but you can also do it in the intended TIMWIN directory, e.g. c:\timwin. **** The feature described below may be not present in some versions **** If, during installation, a file is copied to another directory, the original is removed, to avoid occupying unnecessary disk space. The free disk space calculator in the install program doesn't take this into account, which may result in an warning about insufficient disk space. In this case, it is safe to ignore this warning. If you need to repeat the installation, some files may have been removed. In this case, repeat the unzip procedure. **** end Further see the instructions for 'Installation from floppy disk', except that you specify the install program without argument, but with a path ('c:\timwin\install') Installation from floppy disk ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To install TIMWIN-Demo from floppy disks, insert disk 1 and run install a: or install b: from the Windows program manager (not from the MS-DOS prompt): * In the program manager window, select File and then Run. * Enter 'install a:' or 'install b:' * Answer the questions and installation takes place automatically. If, after installation, TIMWIN complains about memory, replace the file IMAGES.TIM by IMGMIN.XXX, where XXX symbolises the frame grabber you are using (e.g. 'copy imgmin.nof images.tim' if you have no frame grabber) INTROD.WRI An introduction document. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ After successful installation, you are advised to open and study the text in INTROD.WRI. This will give you a compact introduction in TIMWIN's concepts and usage. Running TIMWIN ~~~~~~~~~~~~~~ Each time you invoke TIMWIN, a small command file (*inidemo) runs which initialises the system. It also brings up a help page, which will give some startup information and allows you to browse through the on-line manual to inform yourself about TIMWIN. This may take some time. After you clicked OK in the message box, the help page disappears and TIMWIN is ready to use. First follow the instructions in 'Setting up the system' If you don't have a frame grabber, images must be displayed in a window. There are two options for displaying images on the computer screen; each of them is selected by choosing a specific image definition file ('images.xxx'). If you have a high resolution monitor (at least 800x600 @ 256 colours), use the setup defined in 'images.pqr' (this is the default setup). If you have a standard VGA adapter or less than 256 colours (16), use the setup defined in 'images.nof'. To change the setup, copy the appropriate file into the TIMWIN directory under the name: 'images.tim'. Specifying images processing commands can be done using dialog boxes (from the menu bar in the top of the main window) or using the command line (in the bottom of the main window). It is advised to first familiarise yourself with TIMWIN's concepts by browsing through the on line help (select Help on the main menu or press any other help button to start help). To see some image processing programs running, enter the command *demo1 in the command line. This will start a set of pre-compiled programs, which will give you a good impression of TIMWIN's capabilities. Realise, that the demo's are the most informative on systems having a frame grabber, because then the process can be followed from image to image. If there is no frame grabber, the setup as specified in 'images.pqr' will give you a 'next best' view. On standard VGA systems, the setup as specified in 'images.nof' will give a satisfying view of what takes place, although some intermediate steps will be skipped. If desired, you can run the demo program in single step mode by starting it as follows: *demo1 debug To change execution mode of a running program to debug mode, press the ESC key. Then choose the desired running mode. Setting up the system ~~~~~~~~~~~~~~~~~~~~~ First go to the Contr. menu and select Installation. Press the File Paths button and fill in absolute paths for the command file and image directories (e.g. 'c:\timwin\cmc'). If there is a frame grabber in your system, after the installation you must go to Installation in the Contr menu, to adapt TIMWIN to the settings of your frame grabber. Also, if you use a memory mapped device like a frame grabber under Windows, be sure to have a line like 'EMMExclude=D000-DFFF' in your Windows' System.ini file (in the [386Enh] section. The values must conform the frame grabber's memory base adress). The install program does this for you, but if you have another memory mapped card in your system (e.g. a network adapter), it is advised to check (and modify) the setting manually. The same holds for the Emm386 driver that may be in your Config.sys file. See your DOS manual for details. Feedback ~~~~~~~~ We would like to have feedback from people who have been experimenting with TIMWIN. Please tell us your experiences, either positive or negative. If you have any questions or suggestions about TIMWIN, please contact: For commercial information: For technical information ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~ DIFA bv., Image Processing Dpt. Robert J.Ekkers POBox 3132 Fax no. (31)15 - 626740 4800 DC Breda EMail: ekkers@ph.tn.tudelft.nl the Netherlands Fax no. (31)76 - 711953 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Appendix: After installation, the following files should be in the respective directories: In the TIMWIN directory: TIMWIN.EXE The TIMWIN main program EDITCF.EXE TIMWIN's editor (can also be used for other purposes) TIMDLL.DLL The image processing DLL. It is copied from one of the following files, depending on your frame grabber: TIMPCVIS.DLL TIMFGPLU.DLL TIMPCVIS.DLL TIMVFG.DLL TIMCORTE.DLL COMPDLL.DLL The compiler DLL. Although compiling is disabled in the DEMO version, this DLL is needed to solve references for the other modules, TIMEXQ.DLL The executer DLL. It executes command files IMAGES.TIM The image definition file. It is copied from one of the following files, depending on your frame grabber: IMAGES.CX1 Cortex-I IMAGES.FGD PCVisionPlus (dual frame mode) IMAGES.FGS PCVisionPlus (single frame mode) IMAGES.PCV PCVision IMAGES.VFG VFG and other series 100 frame grabbers IMAGES.NOF No frame grabber, 2 windows images: 'h' and 'i'. IMAGES.PQR No frame grabber, 4 windows images: p, q, r and s Since, in the demo program, pocessing takes place in these images, this setup allows you to follow each step in detail. The following files can be used if memory usage of the above files is too high: IMGMIN.CX1 IMGMIN.FGD IMGMIN.FGS IMGMIN.PCV IMGMIN.VFG IMGMIN.NOF STANDARD.FNT Various text fonts for writing text in images CHIC09.FNT (See the 'text' and 'lcset' commands) COUR11.FNT The number indicates the point size. MONA09.FNT TIME15.FNT TIME15P.FNT UPPER.FNT ALIAS.TIM Alias definitions ERMSGS.TIM Error message texts In the CMC directory: *.CMD Sources of the DEMO command files *.CMC Compiled DEMO command files In the IM directory: *.IM and *.TIF Image files